home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 3 / ct-rom iiib.zip / ct-rom iiib / OS2 / PROGRAM / GBASE211 / INSTALL.HLP (.txt) < prev    next >
OS/2 Help File  |  1994-04-21  |  21KB  |  382 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Guidelines Installation ΓòÉΓòÉΓòÉ
  3.  
  4.                              Guidelines Installation
  5.                                     Welcome!
  6.  
  7. Welcome to the Guidelines Installation program.  This program will perform the 
  8. installation of Guidelines and any optional extension packs. 
  9.  
  10. Help is available at each step of the installation process, so if you are in 
  11. doubt, either press the Help button or press F1. 
  12.  
  13. Press the Ok button to continue. 
  14.  
  15.  
  16. ΓòÉΓòÉΓòÉ 2. Installation Help ΓòÉΓòÉΓòÉ
  17.  
  18.                                 Installation Help
  19.  
  20. Welcome to the Guidelines Installation program.  This program will perform the 
  21. installation of Guidelines and any optional extension packs. 
  22.  
  23. Help is available at each step of the installation process, so if you are in 
  24. doubt, either press the Help button or press F1. 
  25.  
  26. As you complete steps of the installation, a checkmark will be placed alongside 
  27. those items you have finished. 
  28.  
  29.  
  30. ΓòÉΓòÉΓòÉ 2.1. Directories Menu Item ΓòÉΓòÉΓòÉ
  31.  
  32. Directories Menu Item 
  33.  
  34. Selecting this menu item will invoke the Directories dialog, which allows you 
  35. to specify Source and Target directories for the installation. 
  36.  
  37.  
  38. ΓòÉΓòÉΓòÉ 2.2. Options Menu Item ΓòÉΓòÉΓòÉ
  39.  
  40. Options Menu Item 
  41.  
  42. Selecting this menu item will invoke the Options dialog, which allows you to 
  43. select or deselect optional features to install, such as the sample programs, 
  44. and the online documentation. 
  45.  
  46.  
  47. ΓòÉΓòÉΓòÉ 2.3. Install Menu Item ΓòÉΓòÉΓòÉ
  48.  
  49. Install Menu Item 
  50.  
  51. Selecting this menu item will begin the installation of the base Guidelines 
  52. product, using the settings you have selected within the Directories and 
  53. Options dialogs. 
  54.  
  55.  
  56. ΓòÉΓòÉΓòÉ 2.4. Install Extensions Menu Item ΓòÉΓòÉΓòÉ
  57.  
  58. Install Extensions Menu Item 
  59.  
  60. Selecting this menu item will invoke the Install Extensions Selection dialog, 
  61. allowing you to choose a Guidelines Extension Pack to install. 
  62.  
  63.  
  64. ΓòÉΓòÉΓòÉ 2.5. Convert Menu Item ΓòÉΓòÉΓòÉ
  65.  
  66. Convert Menu Item 
  67.  
  68. Selecting this menu item will invoke the Convert GUI Files dialog, which allows 
  69. you to selectively convert GUI files created by earlier versions of Guidelines. 
  70. The GUI files will be upgraded to a file format compatible with the version of 
  71. Guidelines being installed. 
  72.  
  73.  
  74. ΓòÉΓòÉΓòÉ 2.6. Exit Menu Item ΓòÉΓòÉΓòÉ
  75.  
  76. Exit Menu Item 
  77.  
  78. Select this menu item to leave the installation program. 
  79.  
  80.  
  81. ΓòÉΓòÉΓòÉ 3. Options Dialog ΓòÉΓòÉΓòÉ
  82.  
  83. Options Dialog 
  84.  
  85. This dialog allows you to modify the behaviour of the installation program. 
  86. The following settings may be modified: 
  87.  
  88. Γûá Update CONFIG.SYS 
  89. Γûá Create WPS Folder 
  90. Γûá Install Sample Applications 
  91.  
  92.  
  93. ΓòÉΓòÉΓòÉ 3.1. Update CONFIG.SYS ΓòÉΓòÉΓòÉ
  94.  
  95. Update CONFIG.SYS 
  96.  
  97. Guidelines needs to modify several environment variables within your CONFIG.SYS 
  98. file in order to operate correctly.  It will modify the following settings: 
  99.  
  100. LIBPATH     This setting tells OS/2 where to look for Dynamic Link Libraries 
  101.             (.DLL). So that Guidelines may find its own DLLs when it has not 
  102.             been started from its installed directory, the GUIDE\SYS directory 
  103.             is added to this setting. 
  104.  
  105. PATH        The PATH variable is used to find executable (.EXE) programs.  To 
  106.             allow you to run GUIDE from the command line from any directory, 
  107.             the Installation program will add the GUIDE directory to the PATH 
  108.             environment variable. 
  109.  
  110. HELP        This variable tells the Help Manager where to find online help 
  111.             files (.HLP). Guidelines itself, and all the custom controls have 
  112.             help files, so the Installation program will add GUIDE and 
  113.             GUIDE\SYS to the HELP path to find them. 
  114.  
  115. INCLUDE     The INCLUDE path tells the compiler where C/C++ header files 
  116.             (.H/.HPP). The Guidelines runtime and all the controls have their 
  117.             own header files which are needed to compile applications, so the 
  118.             Installation program will add GUIDE\SYS to the INCLUDE path. 
  119.  
  120. LIB         The LIB path tells the linker where to find libraries (.LIB), to 
  121.             link as a final step of building an application.  As with the 
  122.             INCLUDE path, Guidelines and its controls need to know where to 
  123.             find their libraries, so the LIB path will have GUIDE\SYS added to 
  124.             it. 
  125.  
  126. GUE         This setting is specific to Guidelines, as it tells Guidelines 
  127.             where to find the GUE extensions which support the custom controls. 
  128.             This will be set to GUIDE\SYS. 
  129.  
  130. It is recommended that you allow the Installation program to modify CONFIG.SYS 
  131. for you, otherwise you will need to manually edit the file to ensure correct 
  132. operation.  If you opt not to have the changes done automatically, the required 
  133. changes will be written to a file called CONFIG.GL within the target directory. 
  134. These changes can then be applied manually before running Guidelines. 
  135.  
  136.  
  137. ΓòÉΓòÉΓòÉ 3.2. Create WPS Folder ΓòÉΓòÉΓòÉ
  138.  
  139. Create WPS Folder 
  140.  
  141. If this option is selected, the Installation program will create a Guidelines 
  142. folder on your Workplace Shell Desktop, which looks like this: 
  143.  
  144. This folder will contain the following icons: 
  145.  
  146.             The Guidelines editor 
  147.  
  148.             The Installation program 
  149.  
  150.             A folder containing all your GUI files 
  151.  
  152.             A folder of sample Guidelines applications 
  153.  
  154.             A folder containing executables of your applications 
  155.  
  156.             A folder with online versions of the documentation 
  157.  
  158.  
  159. ΓòÉΓòÉΓòÉ 3.3. Install Sample Applications ΓòÉΓòÉΓòÉ
  160.  
  161. Install Sample Applications 
  162.  
  163. If this option is checked, a series of Guidelines applications will be 
  164. installed into their own directories underneath the GUIDE\GUI\SAMPLES 
  165. directory.  There is a wide range of samples GUI files, which illustrate 
  166. important techniques for creating Guidelines applications. 
  167.  
  168. Some applications are small and illustrate key concepts or demonstrate specific 
  169. features of a control, while others are more complex, and illustrate design 
  170. principles and coding examples used by the creators of Guidelines. 
  171.  
  172. It is recommended that all users install these samples, as even experienced 
  173. programmers may learn from them. 
  174.  
  175. Other sample programs will be installed within the GUIDE\BIN directory which 
  176. demonstrate some of the capabilities available in optional Guidelines extension 
  177. packs. GUI files for these programs have not been provided as they require the 
  178. extension packs to support them. 
  179.  
  180.  
  181. ΓòÉΓòÉΓòÉ 4. Installation Directories ΓòÉΓòÉΓòÉ
  182.  
  183. Installation Directories 
  184.  
  185. This dialog allows you to specify the source and target directories to be used 
  186. during the installation of Guidelines.  The following fields can be set: 
  187.  
  188. Γûá Install From 
  189. Γûá Installation Directory 
  190.  
  191.  
  192. ΓòÉΓòÉΓòÉ 4.1. Source Directory ΓòÉΓòÉΓòÉ
  193.  
  194. Source Directory 
  195.  
  196. This is the directory from which you are installing Guidelines.  It would 
  197. normally be A:\ or B:\ if you are installing from a floppy drive. 
  198.  
  199. If you are installing from a directory on a hard drive, the Installation 
  200. program will display the directory from which it was run, which should specify 
  201. the location of the installation files. 
  202.  
  203. This field should not normally be changed. 
  204.  
  205.  
  206. ΓòÉΓòÉΓòÉ 4.2. Target Directory ΓòÉΓòÉΓòÉ
  207.  
  208. Target Directory 
  209.  
  210. This field allows you to specify the directory into which Guidelines will be 
  211. installed.  The default drive for installation is the OS/2 boot drive, and the 
  212. default directory is GUIDE.  If the target directory does not exist, it will be 
  213. created.  If the target directory already exists and contains an existing copy 
  214. of Guidelines, then the system files will be overwritten with the version being 
  215. installed.  Other user files within the target directory will not be affected. 
  216.  
  217. The Installation program will automatically check that there is sufficient 
  218. space to install all the options selected. 
  219.  
  220.  
  221. ΓòÉΓòÉΓòÉ 5. Registration Dialog ΓòÉΓòÉΓòÉ
  222.  
  223. Registration Dialog 
  224.  
  225. This dialog allows you to personalize your Guidelines package.  You should 
  226. enter the following information to before proceeding: 
  227.  
  228. Γûá Registration Number 
  229. Γûá Name 
  230. Γûá Company 
  231.  
  232.  
  233. ΓòÉΓòÉΓòÉ 5.1. Registration Number ΓòÉΓòÉΓòÉ
  234.  
  235. Registration Number 
  236.  
  237. Enter your Registration Number in this field.  Your unique Registration Number 
  238. is supplied with your Guidelines package.  If you have not purchased a 
  239. registered copy of Guidelines, a blank Registration Number will be accepted 
  240. which provides full functionaility within the base product, but will not 
  241. support the use of any Guidelines extension packs. 
  242.  
  243.  
  244. ΓòÉΓòÉΓòÉ 5.2. Name ΓòÉΓòÉΓòÉ
  245.  
  246. Name 
  247.  
  248. Enter your name in this field to customize your Guidelines package. This name 
  249. will appear in the Product Information dialog from within Guidelines.  If no 
  250. Company is specified, this Name will appear in your applications' Copyright 
  251. notices. 
  252.  
  253.  
  254. ΓòÉΓòÉΓòÉ 5.3. Company ΓòÉΓòÉΓòÉ
  255.  
  256. Company 
  257.  
  258. Enter your Company name (if any) in this field.  This Company name will appear 
  259. in your applications' Copyright notices.  If the Company name is not specified, 
  260. the Name will appear in the Copyright notices instead. 
  261.  
  262.  
  263. ΓòÉΓòÉΓòÉ 6. Installation Status ΓòÉΓòÉΓòÉ
  264.  
  265. Installation Status 
  266.  
  267. This dialog shows the progress of the installation.  It displays the actions it 
  268. is performing and shows a graphical bar representing the completion percentage 
  269. of the installation as it progresses.  Pressing the Cancel button will abort 
  270. the installation. 
  271.  
  272.  
  273. ΓòÉΓòÉΓòÉ 7. GUI Files Conversion ΓòÉΓòÉΓòÉ
  274.  
  275. GUI Files Conversion 
  276.  
  277. This dialog allows you to selectively nominate existing application GUI files 
  278. to be converted into a format compatible with the latest version of Guidelines. 
  279. You can optionally select files individually by pressing Select, or have the 
  280. Installation program automatically search all your drives for GUI files. Once 
  281. you have selected the desired files, press the Convert button to update the 
  282. files. 
  283.  
  284.  
  285. ΓòÉΓòÉΓòÉ 7.1. Files List ΓòÉΓòÉΓòÉ
  286.  
  287. Files List 
  288.  
  289. This list displays all the files which have been selected for conversion. Each 
  290. file may be individually selected or deselected by a single click with the Left 
  291. Mouse Button (LMB). 
  292.  
  293. Once you are satisfied with your selections, press the Convert button. 
  294.  
  295.  
  296. ΓòÉΓòÉΓòÉ 8. Install Extensions Dialog ΓòÉΓòÉΓòÉ
  297.  
  298. Install Extensions Dialog 
  299.  
  300. This dialog displays a list of the Extension Packs which are available for 
  301. installation.  Select an Extension Pack to install from the Extension Pack list 
  302. and press the Install button. 
  303.  
  304.  
  305. ΓòÉΓòÉΓòÉ 8.1. Extension Pack List ΓòÉΓòÉΓòÉ
  306.  
  307. Extension Pack List 
  308.  
  309. This list shows all of the Extension Packs which were located on the specified 
  310. source directory. Select an Extension Pack to install, and press the Install 
  311. button to proceed. 
  312.  
  313.  
  314. ΓòÉΓòÉΓòÉ 8.2. Extension Path ΓòÉΓòÉΓòÉ
  315.  
  316. Extension Path 
  317.  
  318. By default, all Guidelines extensions will be installed into the GUIDE\SYS 
  319. directory.  This field allows you to override the directory into which the 
  320. selected extension will be installed. 
  321.  
  322. The directory specified will also be added to the GUE setting in CONFIG.SYS 
  323. (see Update CONFIG.SYS for more information). 
  324.  
  325.  
  326. ΓòÉΓòÉΓòÉ 9. File Selection Dialog ΓòÉΓòÉΓòÉ
  327.  
  328. File Selection Dialog 
  329.  
  330. This is a standard OS/2 dialog which allows you to select one or more GUI 
  331. application files for conversion from earlier releases of Guidelines. 
  332.  
  333. Help is available for the following: 
  334.  
  335. Γûá Name 
  336. Γûá Type 
  337. Γûá Drives 
  338. Γûá Files 
  339. Γûá Directories 
  340.  
  341.  
  342. ΓòÉΓòÉΓòÉ 9.1. Name ΓòÉΓòÉΓòÉ
  343.  
  344. Name 
  345.  
  346. This field shows the currently selected file in the Files list.  You can also 
  347. type in the name of the desired file, if known. 
  348.  
  349.  
  350. ΓòÉΓòÉΓòÉ 9.2. Type ΓòÉΓòÉΓòÉ
  351.  
  352. Type 
  353.  
  354. This combo box allows you to select the Extended Attribute Type of the files to 
  355. display.  It is not currently used. 
  356.  
  357.  
  358. ΓòÉΓòÉΓòÉ 9.3. Drives ΓòÉΓòÉΓòÉ
  359.  
  360. Drives 
  361.  
  362. This combo box shows all the drives available on your system.  To select a file 
  363. on a different drive, simply click on the desired drive in the list. 
  364.  
  365.  
  366. ΓòÉΓòÉΓòÉ 9.4. Files ΓòÉΓòÉΓòÉ
  367.  
  368. Files 
  369.  
  370. This list shows the available GUI files in the current directory. You can 
  371. scroll through the list and select individual files to add to the list of files 
  372. to be converted. 
  373.  
  374.  
  375. ΓòÉΓòÉΓòÉ 9.5. Directories ΓòÉΓòÉΓòÉ
  376.  
  377. Directories 
  378.  
  379. This list shows a hierarchical display of the directories on the current drive. 
  380. To navigate through the list, double-click on the desired directory name.  As 
  381. you change directories, the list of files will be updated with the GUI files in 
  382. that directory.